home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 5 / Amiga Tools 5.iso / grafik / 3d & render tools / irit / man / man6 / setup.6 < prev    next >
Text File  |  1996-07-16  |  7KB  |  162 lines
  1. .TH Setup
  2.  6 "IRIT Version 6.0" 
  3. .SH NAME
  4. Setup
  5.  
  6.  
  7.  
  8. The IRIT program reads a file called irit.cfg each time it is executed.
  9. This file configures the system. It is a regular text file with comments, so
  10. you can edit it and properly modify it for your environment.
  11. This file is being searched for in the directory specified by the
  12. IRIT_PATH environment variable.
  13. For example 'setenv IRIT_PATH /u/gershon/irit/bin/'.
  14. Note IRIT_PATH must terminate with '/'. If the variable is not set only
  15. the current directory is being searched for irit.cfg.
  16.  
  17. In addition, if it exists, a file by the name of iritinit.irt will be
  18. automatically executed before any other '.irt' file. This file may contain
  19. any IRIT command. It is the proper place to put your predefined
  20. functions and procedures if you have some.
  21. This file will be searched much the same way IRIT.CFG is. The
  22. name of this initialization file may be changed by setting the StartFile
  23. entry in the configuration file.
  24. This file is far more important starting at version 4.0, because of the new
  25. function and procedure definition that has been added, and which is used
  26. to emulate BEEP, VIEW, and INTERACT for example.
  27.  
  28. The solid modeler can be executed in text mode (see the .cfg and the -t
  29. flag below) on virtually any system with a C compiler.
  30.  
  31. Under all systems the following environment variables must be set
  32. and updated:
  33.  
  34.     path           Add to path the directory where IRIT's binaries are.
  35.     IRIT_PATH      Directory with config., help and IRIT's binary files.
  36.     IRIT_DISPLAY   The graphics driver program/options. Must be in path.
  37.     IRIT_BIN_IPC   If set, uses binary Inter Process Communication.
  38.  
  39.  
  40. For example,
  41.  
  42.    set path = (path /u/gershon/irit/bin)
  43.    setenv IRIT_PATH  /u/gershon/irit/bin/
  44.    setenv IRIT_DISPLAY "xgldrvs -s-"
  45.    setenv IRIT_BIN_IPC 1
  46.  
  47. to set /u/gershon/irit/bin as the binary directory and to use the sgi's
  48. gl driver. If IRIT_DISPLAY is not set, the server (i.e., the IRIT
  49. program) will prompt and wait for you to run a client (i.e., a display
  50. driver). if IRIT_PATH is not set, none of the configuration files, nor
  51. the help file will be found.
  52.  
  53. If IRIT_BIN_IPC is not set, text based IPC is used, which is far
  54. slower. No real reason not to use IRIT_BIN_IPC, unless it does not
  55. work for you.
  56.  
  57. In addition, the following optional environment variables may be set.
  58.  
  59.     IRIT_MALLOC       If set, apply dynamic memory consistency testing.
  60.                       Programs will execute much slower in this mode.
  61.     IRIT_MALLOC_PTR   Set to a pointer address and the program will
  62.                       scream once this pointer is allocated.
  63.     IRIT_NO_SIGNALS   If set, no signals are caught by IRIT.
  64.     IRIT_SERVER_HOST  Internet Name of IRIT server (used by graphics driver).
  65.     IRIT_SERVER_PORT  Used internally to the TCP socket number. Should not
  66.                       be set by users.
  67.  
  68.  
  69. For example,
  70.  
  71.    setenv IRIT_MALLOC 1
  72.    setenv IRIT_MALLOC_PTR 1234567890
  73.    setenv IRIT_NO_SIGNALS 1
  74.    setenv IRIT_SERVER_HOST irit.cs.technion.ac.il
  75.  
  76. IRIT_MALLOC is useful for programmers, or when reporting a memory
  77. fatal error occurrence. IRIT_NO_SIGNALS is also useful for debugging
  78. when contorl-C is used within a debugger. The IRIT_SERVER_HOST/PORT
  79. controls the server/client (IRIT/Display device) communication.
  80.  
  81. IRIT_SERVER_HOST and IRIT_SERVER_PORT are used in the unix and
  82. Window NT ports of IRIT.
  83.  
  84. See the section on the graphics drivers for more details.
  85.  
  86. A session can be logged into a file as set via LogFile in the configuration
  87. file. See also the LOGFILE command.
  88.  
  89. The following command line options are available:
  90.  
  91.    IRIT [-t] [-z] [file.irt]
  92.  
  93.  
  94.     -t          Puts IRIT into text mode. No graphics will be displayed and
  95.                 the display commands will be ignored. Useful when one needs to
  96.                 execute an irt file to create data on a tty device...
  97.     -z          Prints usage message and current configuration/version
  98.                 information.
  99.     file.irt    A file to invoke directly instead of waiting to input from
  100.                 stdin. 
  101.  
  102.  
  103.  
  104. Under OS2 the IRIT_DISPLAY environment variable must be set (if set) to
  105. os2drvs.exe without any option (-s- will be passed automatically).
  106. os2drvs.exe must be in a directory that is in the PATH environment
  107. variable. IRIT_BIN_IPC can be used to signal binary IPC which is faster.
  108. Here is a complete example:
  109.  
  110.  set IRIT_PATH=c:\irit\bin\
  111.  set IRIT_DISPLAY=os2drvs -s-
  112.  set IRIT_BIN_IPC=1
  113.  
  114. assuming the directory specified by IRIT_PATH holds the executables of
  115. IRIT and is in PATH.
  116.  
  117. If IRIT_BIN_IPC is not set, text based IPC is used which is far
  118. slower. No real reason not to use IRIT_BIN_IPC unless it does not
  119. work for you.
  120.  
  121.  
  122. The NT port uses sockets and is, in this respect, similar to the unix port.
  123. The envirnoment variables IRIT_DISPLAY, IRIT_SERVER_HOST,
  124. IRIT_BIN_IPC should all be set in a similar way to the Unix specific setup.
  125. As a direct result, the server (IRIT) and the display device may be running
  126. on different hosts. For example the server might be running on an NT system
  127. while the display device will be running on an SGI4D exploiting the graphic's
  128. hardware capabilities.  Here is a complete example:
  129.  
  130.  set IRIT_PATH=c:\irit\bin\
  131.  set IRIT_DISPLAY=wntgdrvs -s-
  132.  set IRIT_BIN_IPC=1
  133.  
  134. Under UNIX using X11 (x11drvs driver) add the following options to
  135. your .Xdefaults. Most are self explanatory. The Trans attributes control
  136. the transformation window, while the View attributes control the view window.
  137. SubWin attributes control the subwindows within the Transformation window.
  138.  
  139.     #if COLOR                                                        
  140.     irit*Trans*BackGround:            NavyBlue                       
  141.     irit*Trans*BorderColor:           Red                            
  142.     irit*Trans*BorderWidth:           3                              
  143.     irit*Trans*TextColor:             Yellow                         
  144.     irit*Trans*SubWin*BackGround:     DarkGreen                      
  145.     irit*Trans*SubWin*BorderColor:    Magenta                        
  146.     irit*Trans*Geometry:              =150x500+500+0                 
  147.     irit*Trans*CursorColor:           Green                          
  148.     irit*View*BackGround:             NavyBlue                       
  149.     irit*View*BorderColor:            Red                            
  150.     irit*View*BorderWidth:            3                              
  151.     irit*View*Geometry:               =500x500+0+0                   
  152.     irit*View*CursorColor:            Red                            
  153.     irit*MaxColors:                   15                             
  154.     #else                                                            
  155.     irit*Trans*Geometry:              =150x500+500+0                 
  156.     irit*Trans*BackGround:            Black                          
  157.     irit*View*Geometry:               =500x500+0+0                   
  158.     irit*View*BackGround:             Black                          
  159.     irit*MaxColors:                   1                              
  160.     #endif                                                           
  161.  
  162.